home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audiofile / AFinitinstids.z / AFinitinstids
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaaffffIIIInnnniiiittttIIIInnnnssssttttIIIIDDDDssss((((3333ddddmmmm))))                                          aaaaffffIIIInnnniiiittttIIIInnnnssssttttIIIIDDDDssss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afInitInstIDs - specify a list of instrument parameter chunk identifiers
  10.      to be stored in an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd aaaaffffIIIInnnniiiittttIIIInnnnssssttttIIIIDDDDssss((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt iiiinnnnssssttttiiiiddddssss[[[[]]]],,,, iiiinnnntttt nnnniiiinnnnssssttttssss))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  18.      _s_e_t_u_p     is an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure, previously created by a call to
  19.                aaaaffffNNNNeeeewwwwFFFFiiiilllleeeeSSSSeeeettttuuuupppp(3dm).
  20.  
  21.      _i_n_s_t_i_d_s   is an array of positive integer ID's which are used to
  22.                reference instrument configurations in a file after it is
  23.                created by aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  24.  
  25.      _n_i_n_s_t_s    is the number of instrument configurations requested in _s_e_t_u_p.
  26.  
  27.                For AIFF-C (AIFF), this number should be either 0 or 1.  The
  28.                various other file formats supported by the Audio File Library
  29.                have different support different numbers of instrument
  30.                configurations.  Applications should use the aaaaffffQQQQuuuueeeerrrryyyy(3dm)
  31.                mechanism to determine the number of supported configurations
  32.                for a given file format.
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      aaaaffffIIIInnnniiiittttIIIInnnnssssttttIIIIDDDDssss(((()))) initializes a list of unique instrument ID's which are
  36.      used to reference the instrument configurations in a new audio file after
  37.      it is created by a call to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  38.  
  39.      If you set _n_i_n_s_t_s to 0, aaaaffffIIIInnnniiiittttIIIInnnnssssttttIIIIDDDDssss(((()))) will ignore the _i_n_s_t_i_d_s argument,
  40.      so _i_n_s_t_i_d_s can be a null pointer in this case.
  41.  
  42. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  43.      The Audio File Library will continue to expand the number of supported
  44.      file formats.  The ability of these file formats to store various kinds
  45.      of instrument chunks and instrument parameters will vary.  See
  46.      aaaaffffGGGGeeeettttIIIInnnnssssttttIIIIDDDDssss(3dm) for some important notes about handling this situation.
  47.  
  48. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  49.      afNewFileSetup(3dm), afOpenFile(3dm), afGetInstIDs(3dm)
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.